home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr55 / lxfaq160.zip / LINUXFAQ.05 < prev    next >
Internet Message Format  |  1993-06-09  |  56KB

  1. From getrz!chsun!mcsun!news.funet.fi!hydra!klaava!wirzeniu Wed Jun  9 14:02:43 1993
  2. Xref: getrz comp.os.linux:16156 news.answers:3005
  3. Newsgroups: comp.os.linux,comp.os.linux.announce,comp.answers,news.answers
  4. Path: getrz!chsun!mcsun!news.funet.fi!hydra!klaava!wirzeniu
  5. From: corsini@victor.greco-prog.fr
  6. Subject: Linux Frequently Asked Questions 4/5 [monthly posted]
  7. Message-ID: <1993Jun8.144428.18479@klaava.Helsinki.FI>
  8. Followup-To: poster
  9. Summary: Linux, a small and free unix-like for 386-AT computers.
  10. Sender: wirzeniu@klaava.Helsinki.FI (Lars Wirzenius)
  11. Reply-To: linux@numero6.greco-prog.fr
  12. Organization: Greco Prog. CNRS & LaBRI, Bordeaux France
  13. Date: Tue, 8 Jun 1993 14:44:28 GMT
  14. Approved: linux-announce@tc.cornell.edu (Lars Wirzenius)
  15. Expires: Wed, 21 Jul 1993 13:49:58 GMT
  16. Lines: 1469
  17.  
  18. Archive-name: linux-faq/part4
  19. Last-Modified: 93/06/07
  20. Version: 1.18
  21.  
  22. *********************************************************
  23. *                            *
  24. *   Answers to Frequently asked questions about Linux   *
  25. *                            *
  26. *********************************************************
  27.  
  28. This post contains Part 4 of the Linux FAQ (5 parts).
  29. It must be read *after* the 3 first parts. 
  30.  
  31. ===================================8<====>8============================
  32. CONTENTS (of this part)
  33.  
  34.     IX.     FEATURES             (part4)
  35.     X.     GCC MISC INFORMATION        (part4)
  36.     XI.    SCSI SPECIAL            (part4)
  37.  
  38. ===================================8<====>8============================
  39.  
  40.  
  41. IX. FEATURES 
  42. ============
  43.  
  44.   IX.01)  I've read that linux has virtual consoles, what must I do to
  45. get them?
  46.  
  47. ANSWER: Yes there are, you can access them with the left <alt>-key
  48. together with <Fn>-key. With the Linux Images distribution, 4 consoles
  49. are available, getty runs on them.  
  50. Notice that they are NOT accessible when running X (contrary to some
  51. commercial unices).
  52.  
  53.   IX.02)  When Linux boots, I get the following message "8 virtual
  54. consoles"; how can I acess to the 5-8 vc's ?
  55.  
  56. ANSWER: If you want the getty to run on the 5-8, you should add the
  57. corresponding entries in /etc/inittab. You can also just run sh on
  58. them by using the doshell soft.
  59. And then in either case, the ALT-F[5-8] will access the corresponding
  60. vc.  
  61.  
  62.   IX.03)  What kind of shell is /bin/sh ?
  63.  
  64. ANSWER: It's the Bourne Again Shell, bash-1.12.3 and 
  65. compilation was straightforward, just "make" 
  66. that's all or nearly. 
  67. BTW There does exist different shells for Linux, these are:
  68. bash, rc, zsh, tcsh and pdksh (a korn shell).
  69.  
  70.  
  71.   IX.04)  Does there exist a man page for **** ?
  72.  
  73. ANSWER: Download man.tar.Z from your favorite linux ftp site, there is
  74. most of the fileutils man page -- either **** or g****, example there
  75. is nothing on ld, but there is for gld :) --, check the whatis
  76. database provided. The files in the cat1 dir are pre-formatted man
  77. pages that the man program can use. Quite recently the man pages for
  78. section 2 have been written (thanks Drew) and can be found, at least
  79. at tsx-11 in /pub/linux/docs/man/man2.tar.Z 
  80.  
  81. Also manpages are in the SLS on the b? disks.
  82.  
  83. BTW there is nroff and groff for Linux. Cawf 2.0 works just
  84. fine for simple man pages, and a partial ms support too. 
  85.  
  86.  
  87. Moreover Michael Johnson is the coordinator for man pages under Linux,
  88. he is looking for volunteers, so contact the DOC Channel.
  89.  
  90.   IX.05)  Is there a simple man package (groff is too big):
  91.  
  92. ANSWER: "Cawf -man" also "fm -m" (Al Clark) tsx-11 in
  93.      /pub/linux/binaries/usr.bin/fm.tar.Z 
  94.  
  95.  
  96.   IX.06)  What are the editors available in linux?
  97.  
  98. ANSWER: Right now there are uemacs-3.11, elvis-1.4 (1.5). 
  99. Gnu Emacs is there, read the section devoted to it in the 5th part of
  100. this FAQ. Also the port of mg (micro gnu) has been done and can be
  101. found at least at athos.rutgers.edu (128.6.4.4) 
  102. in pub/linux, mg is the binary and mg.tar.Z is the sources file. You
  103. can also find a PD ed, and elvis has an ex mode. Also available is
  104. Lucid Emacs (available on sunsite.unc.edu in
  105. pub/Linux/apps/editors/lemacs), including binary and info and lisp
  106. trees (it takes about 18MB of disk space). Finnally there are
  107. joe, vile-3.11, elle (Elle Looks Like Emacs), Xedit and aXe.
  108.  
  109.   IX.07)  Does there exist a printer package for Linux?
  110.  
  111. ANSWER: (R. Miller) Yes.  The "plp" package is currently available
  112. under the directory [/pub/linux]/BETA/plp on tsx-11 and its mirrors.
  113. You may also print things manually like so:  cat filename > /dev/lp1 
  114. (Note that though "/dev/lp0" exists, most people find that their
  115. printer is on /dev/lp1.  Use whatever the kernel says that it detects
  116. in the boot-up messages.) 
  117.  
  118.   IX.08)  Are uucp, mail, and/or USENET news available for Linux?
  119.  
  120. ANSWER: (Vince Skakan)
  121.    Yes !!!  At this time, the following (at least) have been
  122.         ported to Linux:
  123.  
  124.         Package name            version
  125.         ------------            --------
  126.         taylor uucp             1.03
  127.         elm                     2.3-pl11
  128.         smail                   3.1.28
  129.  
  130.         C-news                  12/22/91
  131.         tin                     1.1pl4
  132.         trn                     2.2
  133.         nn                      6.4.18
  134.  
  135. [...coming soon - Expect an announcement in the near future concerning
  136. the packages above being made available in binary form in the SLS
  137. distribution and in source form from sunsite.unc.edu and other Linux
  138. archive sites...]
  139.  
  140. If you are interested in the last uucp features, join the UUCP channel
  141. (see  part1 of this FAQ for more details about the multi channels list).
  142.  
  143.   IX.09)  How do I make swapping work?
  144.  
  145. ANSWER: Quite simply, you need the swapon and the mkswap binaries.
  146. Then you can choose between a swap partition or a swap file.
  147. The mkswap is used to write the "swap signature", whilst the swapon
  148. binary is to activate the swapping. 
  149.  
  150. First of all you need a partition :), I assume it's the second of your
  151. first disk namely /dev/hda2, and it's 10MB big
  152. A) swap partition:
  153. you have to indicate it's a swap area, this is done via mkswap
  154. (instead of mkfs) which needs the name of the partition and the size
  155. in blocks (a block is 1Ko big); the optional -c flag is for bad block
  156. checking. So for our example you should perform:
  157. mkswap [-c] /dev/hda2 10000
  158. Then you need to indicate that you want linux to use the swap area,
  159. this is done via swapon. In general it is set in the /etc/rc file,
  160. just put the following entry:
  161. /bin/swapon /dev/hda2
  162. It can also be achieved via the /etc/fstab file
  163. B) swap file:
  164. The process is quite close; you need a partition, and a swap file.
  165. Assume that I prefer a swap area of 4MB (I want to keep some place in
  166. /dev/hda2). I need first to "dd" the file.
  167. dd if=/dev/hda2 of=/swap_file bs=1024 count=4096
  168. bs stands for block size, and count is the number of blocks
  169. then I have to put the "swap signature" on that file:
  170. mkswap /swap_file 4096
  171. At this point, you should 'sync', just to be sure the signature is
  172. effective. And finally add an entry in the rc file:
  173. /bin/swapon /swap_file
  174.  
  175.  
  176.   IX.10)  When I boot I get one of the following messages:
  177. "Unable to find swap signature" or "Bad swap-space bitmap"
  178.  
  179. ANSWER: You probably forgot to make your swap-device, use the mkswap
  180. command. 
  181.  
  182.  
  183.   IX.11)  How do I know if it is swapping?
  184.  
  185. ANSWER: You will notice it :)) First of all, Linux tells you at boot
  186. time, "Adding swap: XXX pages of swap space", and if you start running
  187. out of memory, you will notice that the disk will work overtime, and
  188. things slow down. Generally a 2Meg RAM will make the system swap
  189. constantly while running gcc, 4 Meg will swap occasionnaly when
  190. optimizing big files (and having other things active, such as make).
  191. Also, the command 'free' (from the ps package) reports total enabled
  192. swap space and current swap use.
  193.  
  194.  
  195.   IX.12)  How is it possible to remove a swap file?
  196.  
  197. ANSWER: Simply perform a rm on that file, and remove the swapon of
  198. your /etc/rc file.
  199.  
  200.  
  201.   IX.13)  How is it possible to remove a swap device?
  202.  
  203. ANSWER: mkfs the device, and remove the swapon of your /etc/rc file.
  204.  
  205.   IX.14)  How much swap space do I need ?
  206.  
  207. ANSWER: Linux does not perform real swapping, it's rather paging (see
  208. below for a more complete explanation). The swap area is *added* to
  209. the memory and can be viewed as virtual memory, so choose the size you
  210. need, example:
  211.  
  212.         8MB RAM + 6MB swap => 14MB virtual memory
  213.  
  214.   IX.15)  Could someone explain the swap process on Linux?, is it
  215. swapping or paging ?
  216.  
  217. ANSWER: (Linus) Linux uses swap as /additional/ memory, one page of
  218. the swap-space is used for the good-page bitmap and the swapspace
  219. signature. 
  220. In fact Linux does only paging, no swaping in the meaning "write out
  221. one whole process to disk".
  222. The reason it's called swapping is that Linux used paging for memory
  223. management on a low level since the very beginning, but didn't page to
  224. disk at all until 0.12. 
  225.  
  226.   IX.16)  Is demand paging different from paging and How ?
  227.  
  228. ANSWER: (Linus) Demand-paging is really "demand loading of
  229. executables" and is totally independent of the page-swapping
  230. algorithms, although they have similarities. When Linux strts up a
  231. process, no actual code space is loaded: I let the page exceptions
  232. load in the executable as needed. Thus Linux demand-loads the code and
  233. initialized data it needs.
  234. Demand-loading has very good points: (a) it simplifies the exec system
  235. call; (b) it means page sharing between that have excuted the same
  236. file is easy to implement; (c) it cuts down on the amount of memory
  237. required. When Linux runs out of real memory, it starts to lock for
  238. pages it can swap out, but if it notices that the page is clean, it
  239. just forgets about it, and demand-loads it when it's needed again.
  240. Thta means that swap-file isn't needed as much, especially when
  241. running big binaries such as gcc, where the code-pages can be
  242. demand-loaded as you wish.
  243.  
  244. Point (c) means that even without any swap space, you can usually run
  245. slightly larger programs that your memory setup would actually permit.
  246. I've noticed this while running X and doing a kernel compilation +
  247. something else wshen I've forgotten to turn on swapping: free reports
  248. 0 page available but things still work, although performance is
  249. slightly down... 
  250.  
  251.   IX.17)  Is there any way to tell how much swap space you are using
  252. or have left? 
  253.  
  254. ANSWER: The free program provided with the ps package handles this.
  255.  
  256.  
  257.   IX.18)  I have a 2Megs box, but "free" reports only 1Meg why?
  258.  
  259. ANSWER: (Linus:) "free" doesn't concern with the memory the kernel has
  260. allocated for itself. In other words what you see is the *user* memory
  261. available. The kernel has taken the low 1Meg for it's use (~250Ko for
  262. it and the rest for buffer cache and kernel data structures); for big
  263. memory machine it could be even 2Megs.
  264.  
  265.   IX.19)  What tape drives work with Linux ?
  266.  
  267. ANSWER: (24 sept. P. Riipinen)
  268. - There is a working QIC-02 device driver for Linux, supporting (at
  269.   least) Everex/Wangtek cards.
  270. - There are additional patches for the QIC-02 to support Archive
  271.   SC402/499R. You can find them in /pub/linux/alpha/qic-02 at tsx-11
  272.   There are some bugs in the driver but you can backup.
  273. - Newer drivers are all SCSI, so check the SCSI section in this FAQ.
  274.  
  275.   IX.20)  Is there only the %$#@ keyboard ?
  276.  
  277. ANSWER: There are Dannish, Finnish, French, German, Uk, US and DVORAK 
  278. keyboards. Set it in the main Makefile of the kernel sources, then  
  279. (re)compile the kernel again. Make sure the files in kernel/chr_drv
  280. directory are recompiled.   
  281.  
  282.  
  283.   IX.21)  (special FINNISH/US) I booteed up with the new image and
  284. everything work except that some keyboard keys produce wrong
  285. characters. Does anyone know what is happening?
  286.  
  287. ANSWER: Since 0.95a images are US product (and so are US-keyboard
  288. oriented), BUT linux sources are FINNISH product, and so the default
  289. keyboard is set to be FINNISH. The solution is in the previous Q/A.
  290.  
  291.  
  292.   IX.22)  Does there exist shared libs ?
  293.  
  294. ANSWER: (H.J. Lu, hlu@eecs.wsu.edu, 09/01/92)
  295.  
  296. The shared library under Linux started at 0.12. Peter MacDonald
  297. collaborating with Linus made the first generation of shared library,
  298. which is the base of the classic shared library which is no longer widely
  299. used.
  300.  
  301. The kernel support of shared library under Linux is system call
  302.  
  303. extern int uselib (const char *__filename);
  304.  
  305. which loads an executable image with fixed entry point into memory,
  306. just like the ordinary executables.
  307.  
  308. In crt0.s, a function which can find out if and which shared images
  309. are needed and loads them is invoked before `main ()' is called if
  310. necessary. David Engel and I developed a way to tell the loader which
  311. shared images have to be loaded, utilizing the similar technique used
  312. in global constructor in g++ 2.x with the help from GNU binary
  313. utilities.
  314.  
  315. In the classic Linux shared library, we build a big executable image 
  316. for several libraries and make sure no external variables outside of
  317. the participating libraries are referenced. Then we can get the
  318. absolute addresses of all the global variables defined in the
  319. libraries used to build that executable image. After that, we make a
  320. stub library for each participating library which just has the
  321. absolute addresses of all the global variable in it.
  322.  
  323. For each shared image, there must be one and only one .o file, which
  324. defines a global variable containing version, name and entry point of
  325. the shared image, and a dummy global data. Among those libraries used
  326. to build the shared image, there must be one library which will always
  327. be referenced whenever any other library is referenced. We put this .o
  328. file into the stub library for that library and add a special symbol
  329. to each of the components of the stub library in order to make sure
  330. that this .o file is always linked in if any of the participating
  331. libraries are linked.
  332.  
  333. In gcc 2.2.2d, jump table, developed by David Engel, was introduced in 
  334. the shared library. At the beginning of each shared image, there is
  335. a table in which every library function has a fixed entry address and
  336. the instruction at that address is a jump which will lead to the
  337. real library function. So we can change the library function without
  338. changing the corresponding entry address of the jump table. For the
  339. global data we put them at the beginning of data section of the shared
  340. image. We have to separate them from text code and link them in fixed
  341. order. It is very hard to maintain the same addresses for the global
  342. data when library is changed. After the global data are set up properly
  343. and some spaces are left for possible future changes (that is a very
  344. tough procedure.), it isn't too difficult to maintain.
  345.  
  346. Starting with libc.4.3, a form of dynamic linking developed by Eric
  347. Youngdale was introduced into the shared libraries.  As part of this,
  348. the tools that were used to generate the sharable libraries were
  349. completely redone which made the job of building the libraries much
  350. easier, and thus the libX*.so.3.0 libraries were made as DLL jumptable
  351. libraries.
  352.  
  353.   IX.23)  Why do I need dynamic linking.
  354.  
  355. ANSWER: The best way to illustrate this is with a simple example of
  356. what happens without dynamic linking.
  357.  
  358.     #include <stdio.h>
  359.  
  360.     int errno;
  361.     FILE * foo;
  362.  
  363.     main(){
  364.         foo = fopen("/usr/bin/foo","w");
  365.         printf("foo: %x errno: %d\\n",foo, errno);
  366.     }
  367.  
  368. Assume this program is run by a non-root user. Normally you would
  369. expect that the open will fail because the user does not have
  370. permission to write to /usr/bin - this means that fopen() would return
  371. NULL, and errno would contain 13, which means EACCES - Permission
  372. denied. If you link this to a normal jump table library, it prints
  373.  
  374.     foo: 0  errno: 0
  375.  
  376. Now consider the following nearly identical program:
  377.  
  378.     #include <stdio.h>
  379.  
  380.     extern int errno;
  381.     FILE * foo;
  382.  
  383.     main(){
  384.         foo = fopen("/usr/bin/foo","w");
  385.         printf("foo: %x errno: %d\\n",foo, errno);
  386.     }
  387.  
  388. The results for this program are:
  389.  
  390.     foo: 0  errno: 13
  391.  
  392. Why does this happen???. First of all you must realize that in the
  393. first program errno is not declared external, and thus storage will be
  394. allocated in the data segment for the variable. Unfortunately there
  395. is no way to tell libc this, and libc has it's own storage for errno.
  396. Thus libc writes the result in one location and you are looking in the
  397. other. In the second program errno is declared extern, and thus no
  398. storage will be allocated. The linker will see the need for a
  399. definition of errno, and it will find one in libc. Thus in the second
  400. example the user program is reading the same memory location that the
  401. library stored the answer in.
  402.  
  403. This is of course a simple example. There are more complicated
  404. examples involving programs that want to redefine a library function
  405. and these can lead to quite bizarre behavior which is difficult to debug.
  406.  
  407. With dynamic linking, both of the above programs yield the same
  408. (correct) result.
  409.  
  410.   IX.24)  How does dynamic linking work under linux?
  411.  
  412. ANSWER:  Basically, to implement dynamic linking we need to route all
  413. function calls to global functions through the jump table. We also
  414. need to make sure that all global data is accessed indirectly through
  415. a pointer. The actual libraries do not really look very much
  416. different from the actual jump table libraries that we are currently
  417. using, but there are additional pointers to the global data in the
  418. sharable image that are used internally by the library to access all
  419. global data. There are also additional symbols in the stub library
  420. that are defined as the address of the various pointers, and are used
  421. by the linker to help determine whether there is a pointer or a jmp
  422. instruction that needs to be fixed up.
  423.  
  424.     The linker has one new important task with dynamic linking.
  425. It watches for duplicate definitions of symbols, and if the
  426. second definition is in a sharable library, it makes a note of it as a
  427. conflict that needs to be resolved at run time. The linker puts a list
  428. of all of these conflicts into a table and makes it available to crt0
  429. through the variable __SHARABLE_CONFLICTS_.
  430.  
  431.     At run time, crt0 (through the function __dynamic_resolve)
  432. will go through and fix up all of the pointers that need to be fixed.
  433. Let us say for example that you define your own malloc function in a
  434. program - in this case at run time the startup code will actually
  435. modify the jmp instruction in the jump table so that it points to the
  436. malloc function in your program, not the one in the library.  The
  437. library will never refer to the malloc function directly, but it will
  438. always be referenced through the jump table - in this way we ensure
  439. that there will only be one function named malloc that is used by a
  440. given program.
  441.  
  442.     If you were to run the first example program in the "Why do I
  443. need dynamic linking" answer, then the pointer in the library that
  444. corresponds to the variable errno will be modified so that it points
  445. to the errno variable that is in your program.  The library itself
  446. will never use errno directly - it will always use it via the special
  447. pointer variable.  In this way we ensure that all references to the
  448. variable errno both in your program and in the sharable library will
  449. reference the same memory address.
  450.  
  451.   IX.25)  Does Linux work for SCSI drives?
  452.  
  453. ANSWER: Yes since v0.96. Read the section devoted to SCSI in this FAQ
  454. (check the TOC file to find the section).
  455.  
  456.  
  457.   IX.26)  Linux is supposed to work with ESDI drive. However I have
  458. trouble with my Magtron MT-4115E (Joincom controler), any clue?
  459.  
  460. ANSWER: (Linus) Some harddisk don't like linux (even though they
  461. should). Maybe not a bug but a deficiency.
  462. (Mika) I had to remove the printk "unexpected hd interrupt" statement
  463. in hd.c because I was getting so many of those messages. Be warned
  464. that if there is any read error the system just hangs, even the
  465. ctrl-alt-del won't work. You should be able to use your ESDI drives if
  466. you could live with those nuisances.
  467.  
  468.   IX.27)  How does one go about applying a patch to Linux ?
  469.  
  470. ANSWER: (Drew Eckhardt) In the unix world most of distribution are in
  471. source form. This includes the operating system. To apply a patch, you
  472. apply it with the 'patch' program to the affected sources. The patch
  473. program takes as input the differences between the old and the new
  474. version. After patching you need to recompile the sources.
  475.  
  476. Assume I want to apply a patch enclosed in the file XXX. First of all
  477. I will look at the top of XXX, where the file affected is identified.
  478. This may have aleading path attached to it. Either cd out to the
  479. "root" of the patch, ie if I see
  480. linux/kernel/blk_drv/blk.h
  481.  
  482. I would cd into /usr/src 
  483. (assuming it's the place where I can find linux/kernel...) 
  484. and then patch as follows
  485. patch -p0 < whatever_place/XXX
  486.  
  487. or, you can specify a number of path components to strip from the
  488. path. If I am in the blk_drv directory patching would be
  489. patch -p3 < whatever_place/XXX
  490.  
  491.  
  492.   IX.28)  There are a lot of patches available (ps patch, NFS patches,
  493. CD-ROM patches ...) can I be fairly confident the subsequent patches will
  494. work?
  495.  
  496. ANSWER: This is not true yet for the current version; but it will be
  497. so I kept it :) 
  498. No you can't, patching is a real beta tester art :)).  People are not
  499. working on the same patched release, so you have to check if the
  500. patches you already applied works on the same kernel part, if not,
  501. /great/, just apply them. If yes, check if there is an order, patch
  502. creator knows that, and (should) try to warn patch user (in other
  503. words: beta tester) otherwise you should edit the patch files (and
  504. possibly make a brief note to others on this list/newsgroup or even a
  505. cdiff) before applying them, another solution is to keep cool and wait
  506. for the next version of Linux where, in general, the modifications
  507. have been done but this behavior is /not/ Linux helpful.
  508.  
  509.  
  510.   IX.29)  I got the patches on some ftp sites, and applied them to the
  511. kernel and tried to compile. It didn't !!. Are the patches buggy?
  512.  
  513. ANSWER: Before remake, just do a make clean in the directories
  514. involved by the patches. This will force a rebuild of the .o and .a
  515. files. 
  516. If you have a RCS running on your source tree, did you checked a
  517. patched version of the files changed before /any/ CO either by you or
  518. make
  519.  
  520. Finally, make sure the patches succeded. Normally, failed patches on a
  521. file FILE will leave a FILE# file. Moreover you will get a "chunk
  522. failed" message. It is possible to capture the output while patching,
  523. with the following:
  524.  
  525.     patch -p0 < patchfile | 2>&1 patch.result | more
  526.  
  527.  
  528.   IX.30)  What is VFS?
  529.  
  530. ANSWER: (Ted) Linux 0.96 already has Virtual FileSystem, which means
  531. that it acts as a filesystem switch. It makes it easy for someone to
  532. design another filesystem format and include it in the Linux kernel
  533. along with the standard minix filesystem format. So it /enables/
  534. someone to design a robust filesystem which would have some nice
  535. properties (no 14 chars file name limitation, nor 64Meg limit), and
  536. could be included in the kernel in such a way that both the Minix and
  537. the new one could be mounted at the same time. This solves the
  538. uncompability problem; since the root disk could still use the Minix
  539. filesystem, while the hardisk could be using the new one.
  540.  
  541.  
  542.  
  543.   IX.31)  What's about Bus Mice ?
  544.  
  545. ANSWER: (Nathan I. Laredo) Since the Linux v0.96c-pl2 the kernel does
  546. support LOGITECH and BUS MICE 
  547. If you are unsure that you have a bus mouse or not, check to see if
  548. your mouse card has a selection for a sample rate switchable between
  549. 30Hz and 60Hz (or possibly 25/50Hz), if it does not, then it is NOT a
  550. true  bus mouse (InPort mice for example will not work with this
  551. driver). 
  552. To create a bus mouse device:
  553. mknod /dev/mouse c 10 0
  554.  
  555.  
  556.   IX.32)  What's about TeX ?
  557.  
  558. ANSWER: The primary site for Linux TeX is 129.78.66.1, this is 
  559. P. Williams' site in Australia. The stuff at tsx-11 was posted by 
  560. T. Dunbar  who does support/maintain the dvilj stuff.
  561.  
  562.  
  563.   IX.33)  What's about LILO ?
  564.  
  565. ANSWER: (Werner Almesberger)
  566. LILO  -  Generic Boot Loader for Linux ("LInux LOader") 
  567.  
  568. This is an ALPHA test release of a new boot loader. Be sure to have
  569. some means to boot your system from a different media if you install
  570. LILO on your hard disk.
  571.  
  572. Features
  573. --------
  574.  
  575. - does not depend on the file system. (Tested with Minix, EXT FS and MS-DOS
  576.   FS.)
  577. - can be used to boot from floppies and from hard disks.
  578. - can replace the master boot record.
  579. - can boot non-Linux systems (MS-DOS, DR DOS, OS/2, ...) and unstripped
  580.   kernels.
  581. - supports up to 16 different boot images that can be selected at boot
  582.   time. Root and swap disk/partition can be set independently for each
  583.   image.
  584. - boot sector, file map and boot images can be all on different disks or
  585.   partitions.
  586.  
  587.  
  588. Restrictions and known problems
  589. -------------------------------
  590.  
  591. - SCSI disks are not fully supported yet. (Still waiting for some kernel
  592.   changes.) (Should work in current release - EY).
  593. - booting other operating systems doesn't seem to work everywhere. If
  594.   everything but booting a non-Linux OS from LILO works on your system,
  595.   you should boot LILO by BOOTACTV and select the alternate OS with the
  596.   latter as a temporary work-around.
  597. - booting non-Linux systems from the second hard disk ("D:") is not yet
  598.   supported.
  599.  
  600. Please send all bug reports to almesber@nessie.cs.id.ethz.ch
  601.  
  602.  
  603.   IX.34)  What's about MGR ?
  604.  
  605. ANSWER: (General Information grabbed from various sources)
  606. There is a MGR channel available , contact the request adress with
  607. help in the body: linux-activists-request@niksula.hut.fi 
  608. The stuff can be found at tsx-11 in pub/linux/packages/MGR
  609. In brief:
  610.  
  611. MGR provides:
  612.     - multiple overlapping windows
  613.     - multiple fonts
  614.     - text and graphics in each windows
  615.     - a simple popup menu package
  616.     - a client/server model 'a la' X
  617.     - independance from any peculiar networking technology
  618.  
  619. MGR consist of a server process and some clients. Each client has his
  620. own window, and can create subwindows. Clients communicate with the
  621. server via a bidirectionnal channel. A C library is provided.
  622.  
  623. When a new window starts, it is as a terminal emulator running the
  624. shell; for more information you can grab the mgr-man.out from
  625. bellcore.com 
  626.  
  627. The information hereafter appeared on the MGR channel on 19th Jan. 
  628. > From: u31b3hs@POOL.informatik.rwth-aachen.de
  629. > Subject: MGR 0.53
  630. >
  631. >
  632. > MGR, version 0.53 for Linux and SunOS (Coherent unfinished yet).
  633. >
  634. > Unpack the src* stuff under in /src/lbin/mgr and the usr* stuff in 
  635. > /usr/mgr.  I splitted things that way for making it easier to ftp
  636. > them and carry them home.  If you don't like these paths, then use
  637. > others, but remember to edit the Configfile after generating it. 
  638. > YOU NEED TO INSTALL ALL FILES FOR COMPILING.
  639. >
  640. > This is a beta release for programmers, there are no binaries.  It
  641. > makes my work available for people who either also work on MGR and
  642. > like to get new sources and for adventerous beta testers.  WARNING:
  643. > I assume using Linux 0.99.2 and GCC 2.3.3.
  644. >
  645. > There is some new m4 code to generate menus.  It is more powerful
  646. > than menu(1), but a little harder to use.
  647. >
  648. > MGR is currently being ported to Coherent 4.0, but this version
  649. > doesn't include everything yet.  There is already a beta version
  650. > running on Coherent, although not too stable yet.
  651. >
  652. > For questions, write to the mailing list, channel MGR.  Please be
  653. > sure to talk about the latest version of MGR plus having read the
  654. > README files in the directories containing the problem.
  655. >
  656. > You got this stuff from ftp.thp.uni-koeln.de:pub/linux/mgr or from 
  657. > tsx-11.mit.edu:~ftp/pub/linux/packages/MGR, which is a mirror of the
  658. > Cologne directory.
  659.  
  660.   IX.35)  I have successfully compiled MGR, but when I try to run the
  661. program I get "can't find mouse" or "already in use", any clue?
  662.  
  663. ANSWER: try the following "mgr -m /dev/ttys1" if the mouse is on
  664. the serial 1. Another possibility is to link /dev/mouse with
  665. /dev/ttys1 (assuming your mouse is on serial 1). Or if it's a bus
  666. mouse, "mknod /dev/mouse c 10 0" once.
  667.  
  668.   IX.36)  Any tips for MGR?
  669.  
  670. ANSWER: Well, I have tried it on my 386Sx Ega/Vga; the screen is Ok
  671. but the Logitech mouse I have is not well recognized.
  672.  
  673. BTW check the major/minor number for pty's; they should be character
  674. device with 4 as major and 128 and bigger as minor:
  675. ptyp0 c 4 128
  676. ptyp1 c 4 129
  677. ...
  678. ttyp0 c 4 192
  679. ttyp1 c 4 193
  680.  
  681.   IX.37)  What's about X11 ?
  682.  
  683. ANSWER: See the section XII. devoted to X11 in this FAQ.
  684.  
  685.  
  686.  
  687. X. GCC MISC INFORMATION
  688. =======================
  689.  
  690. **** Last update 93/03/26
  691.  
  692.  
  693. X.A. HLU Information
  694. X.B. OTHERS
  695.  
  696.  
  697. X.A. HLU Information
  698. ~~~~~~~~~~~~~~~~~~~~
  699.  
  700. The official release of GCC for Linux is 2.3.3.
  701. This section includes:
  702.     README.gccdisk
  703.     FAQ of gcc written by HLU
  704.  
  705.  
  706.  
  707.    X.01)  I don't know how to install gcc stuff, is there special
  708. places?
  709.  
  710. ANSWER: This is the README.gccdisk
  711.  
  712.                     Linux GNU C/C++ [HJ release]
  713.  
  714. Introduction
  715. ------------
  716.   This is GNU C/C++ 2.3.3. It is linked with jump table 4.2. You should use
  717.   it with the Linux C library disks since the C/C++ compiler has no shared
  718.   images, which are required by all the binaries in it.  It consists of
  719.   2 minix disks, which will fit on either 5.25" or 3.5" floppies.
  720.  
  721.   It is on tsx-11.mit.edu under pub/linux/GCC/gccdisk
  722.  
  723.  
  724. Distribution File Format
  725. ------------------------
  726. There are two files, each of which goes on one disk
  727.  
  728.   A. Disk 1 (gcc233a.Z)
  729.  
  730.   This contains gcc, cpp, cc1 and crt0.o/gcrt0.o.  There are also some header
  731.   files in /usr/lib/gcc-lib/i386-linux/2.3.3/include.
  732.  
  733.   B. Disk 2 (gcc233b.Z)
  734.  
  735.   This disk contains cc1plus.
  736.  
  737.  
  738. Installing on the Hard Drive
  739. ----------------------------------------
  740.   1. uncompress base[1|2].Z.
  741.   2. rawrite or dd each file to a formatted floppy disk.
  742.  
  743.   Now you have made a copy of gcc 2.3.3 on two floppies.  To copy each
  744.   floppy to your hd, you should mount the floppy and copy its contents to
  745.   your hard drive.  You can do this by:
  746.  
  747.     mount /dev/fd[0|1] /mnt
  748.     cd /mnt
  749.     for d in bin dev etc usr
  750.     do
  751.       if [ -d $d ]; then
  752.         cp -av $d /
  753.       fi
  754.     done
  755.  
  756.   Note: This may overwrite some files on your hard disk.
  757.  
  758. Thanks.
  759.  
  760. H.J.
  761. hlu@eecs.wsu.edu
  762. 12/31/92
  763.  
  764.  
  765.    X.02)  What compiler should I use for Linux?
  766.  
  767. ANSWER: You should only use the same version on tsx-11.mit.edu under
  768. /pub/linux/GCC. If you want to use the testing release, first join
  769. the GCC channel on the Linux mailing list, and then send a note to
  770. hlu@eecs.wsu.edu. Don't use gcc older than the one on tsx-11.mit.edu.
  771.  
  772.    X.03)  Where is the latest official gcc 2.xx for Linux?
  773.  
  774. ANSWER: It's on tsx-11.mit.edu under /pub/Linux/GCC and under
  775. pub/linux/GCC. You may find it on the other sites. Since gcc 2.3.3,
  776. you can compile it yourself out of box from any gnu ftp sites. Just
  777. unpack the source code and do
  778.  
  779.     configure [i386-linux|i486-linux]
  780.  
  781. You should follow the instructions in INSTALL.
  782.  
  783.    X.04)  Where is the latest official Linux C library?
  784.  
  785. ANSWER: It's on tsx-11.mit.edu under /pub/Linux/GCC and under
  786. pub/linux/GCC. You may find it on the other sites.
  787.  
  788.    X.05)  What are the contents of them?
  789.  
  790. ANSWER: Please read the current release note and ChangeLog for
  791. details.
  792.  
  793.    X.06)  How do I install them?
  794.  
  795. ANSWER: Read README and release notes.
  796.  
  797.    X.07)  What are the main differences with the old release?
  798.  
  799. ANSWER: Read README and release notes.
  800.  
  801.    X.08)  Can I use the old version of gcc?
  802.  
  803. ANSWER: Please get rid of gcc older than gcc 2.2.2. Starting from
  804. gcc 2.2.2, you can do
  805.  
  806.     gcc -V xxxx
  807.  
  808. where xxxx is the version number. Please read `release.xxxx' for
  809. detail. There is one catch in gcc 2.2.2d, setjmp/longjmp is changed,
  810. so the old header files is not compatible with gcc 2.2.2. Before you
  811. install gcc 2.2.2d, please do
  812.  
  813. cp /usr/include/setjmp.h /usr/lib/gcc-lib/i386-linux/2.2.2/include
  814.  
  815. where /usr/include/setjmp.h is come with gcc 2.2.2.
  816.  
  817.    X.09)  Can I delete the old shared image in /lib?
  818.  
  819. ANSWER: Since the Linux C library version 4.3, we have introduced the
  820. dynamically linked library. There is no need to keep old shared images
  821. in /lib if none of your binaries are linked with the classic shared
  822. library which has been obsolete. You can just keep one version of
  823. the shared image in /lib which has the highest major and minor
  824. release numbers for each shared library. The name of the shared image
  825. is "xxxxxxxxxxxxxxx.so.major.minor".
  826.  
  827.    X.10)  Is stdio ANSI compatible?
  828.  
  829. ANSWER: Yes, please test it.
  830.  
  831.    X.11)  Is g++ in 2.xx?
  832.  
  833. ANSWER: Yes.
  834.  
  835.    X.12)  Where can I get the gcc manual?
  836.  
  837. ANSWER: You can get man pages and manual come with the gcc source code
  838. on any gnu ftp sites. You should find gcc-man.tar.z on tsx-11 which
  839. has man pages for gcc.
  840.  
  841.    X.13)  What options can I use for gcc?
  842.  
  843. ANSWER: Read the manual. There is one special flag for Linux, -static
  844. tells gcc to use the static libraries. The default is the jump table
  845. version of shared libraries.
  846.  
  847.    X.14)  How can I debug the C code?
  848.  
  849. ANSWER: Read the gcc/gdb manuals. The simple way to do is
  850.  
  851.     gcc -g foo.c -o foo
  852.     gdb foo
  853.  
  854.    X.15)  Where is the source code of the new libc.a?
  855.  
  856. ANSWER: The same place you find this file. It is called
  857. libc-xx.yy.tar.z.
  858.  
  859.    X.16)  Why does g++ complain, even die?
  860.  
  861. ANSWER: You need "expr", which is in GNU shell utilities 1.6, echo (?)
  862. and sed.
  863.  
  864.    X.17)  How do I generate code for 486?
  865.  
  866. ANSWER: Add -m486 to CFLAGS.
  867.  
  868.    X.18)  I heard malloc (0) wouldn't work with Linux, what should I
  869. do?
  870.  
  871. ANSWER: It *does* work in a manner which POSIX allows; unfortunately,
  872. pre-POSIX code frequently assumes that malloc(0) will not return
  873. 0 -- the standard version of malloc under Linux *does* return 0.
  874. By including <stdlib.h>, you get a definition of malloc which behaves
  875. more traditionally.  If you define NO_FIX_MALLOC, then you will get
  876. the default (non-traditional) form.  If you are trying to develop POSIX
  877. compliant code under Linux, you should probably define NO_FIX_MALLOC to
  878. ensure that your code doesn't make assumptions about malloc() which
  879. will not work on other systems.  (Note: NO_FIX_MALLOC is specific to
  880. Linux.)
  881.  
  882. (Provided by Phil.Richards@prg.oxford.ac.uk. Thanks.)
  883.  
  884.    X.19)  Why does gcc say "xxxxx..h not found"?
  885.  
  886. ANSWER: see QUESTION: What are the contents of them?
  887.  
  888.    X.20)  I really followed every step in the documentation, but when
  889. I do "make", why does it say "don't how to make xxxxxx"?
  890.  
  891. ANSWER: The dependency in Makefile is dated, you need to make a new
  892. one. Please get some guide on make and read Makefile. For the kernel
  893. sources, please do
  894.  
  895. cd src/linux
  896. make dep
  897.  
  898.    X.21)  How do I compile programs under Linux?
  899.  
  900. ANSWER: The Linux C library is trying to be ANSI/POSIX compliant. It
  901. is also very compatible with SYSV and BSD. The C library is loaded
  902. with SYSV and BSD functions. There are three exceptions:
  903.  
  904. 1. signal in Linux is POSIX.
  905. 2. tty in Linux is POSIX.
  906. 3. time functions are POSIX, plus a few BSD and SYSV extensions.
  907. 4. setjmp/longjmp functions are POSIX. But you can use -D__FAVOR_BSD
  908.    to make it BSD or use sigsigjmp/siglongjmp.
  909.  
  910. When you compile a program under Linux, your best bet is include all
  911. the appropriate header files and use -Wall. All the usable functions
  912. and global variables are declared in the corresponding header files.
  913. YOU SHOULD NOT DEFINE ANY functions or global variables OF THE LINUX C
  914. LIBRARY IN YOUR CODE IF YOU WANT TO USE THE SHARED LIBRARIES.
  915.  
  916. After saying all those, you now should know you can compile a program
  917. with -D_POSIX_SOURCE or -D_GNU_SOURCE (read <features.h> for details).
  918. With a few modifications you can even use -DSYSV, -DUSG or -DBSD. Some
  919. codes need to define -DSTDC_HEADERS for ANSI C compiler like gcc here.
  920.  
  921. To use malloc () and calloc () safely under Linux, please include
  922.  
  923. <stdlib.h> and don't define NO_FIX_MALLOC.
  924.  
  925. BTW, gcc -traditional should work with gcc 2.2.2d or above.
  926.  
  927. Please also read ChangeLog for the latest enhancement.
  928.  
  929. Please read the header files for details. Maybe you should get a book
  930. on POSIX. Any suggestion of the book list?
  931.  
  932. >From Steve Robbins  --  steve@nyongwa.cam.org
  933.  
  934. --------
  935. I like "POSIX Programmer's Guide", by Donald Lewine.  Its essentially
  936. a list of POSIX functions' man pages, with a very brief guide in the
  937. beginning of a few things.  It's published by O'Reilly & Associates,
  938. Inc.
  939. --------
  940.  
  941.    X.22)  How can I get bsd style signal?
  942.  
  943. ANSWER: Use -D__USE_BSD_SIGNAL.
  944.  
  945.    X.23)  Why does a program that should only poll for input become
  946. a CPU hog?
  947.  
  948. ANSWER: The select() system call. The timeout parameter was classically
  949. used read-only by the system. Some manual pages already notes three
  950. years ago:
  951.  
  952.        select() should probably return the  time  remaining  from
  953.        the  original timeout, if any, by modifying the time value
  954.        in place.  This may be implemented in future  versions  of
  955.        the system.  Thus, it is unwise to assume that the timeout
  956.        pointer will be unmodified by the select() call.
  957.  
  958. If you do not take this advice seriously you get a zero timeout written
  959. back to your timeout structure, which means that future calls to
  960. select() using the same timeout structure will immediately return.
  961.  
  962. Fix:
  963. Put the timeout value into that structure every time you call select().
  964. Change code like
  965.  
  966.        struct timeval timeout;
  967.        timeout.tv_sec = 1; timeout.tv_usec = 0;
  968.        while (some_condition)
  969.          { select(n,readfds,writefds,exceptfds,&timeout); }
  970.  
  971. to
  972.  
  973.        struct timeval timeout;
  974.        while (some_condition)
  975.          { timeout.tv_sec = 1; timeout.tv_usec = 0;
  976.            select(n,readfds,writefds,exceptfds,&timeout);
  977.          }
  978.  
  979.    X.24)  When a program is stopped using Ctrl-Z and then restarted,
  980. or in other situations that generate signals: Ctrl-C interruption,
  981. termination of a child process etc. why does it complain about
  982. "interrupted system call" or "write: unknown error" or things like that.
  983.  
  984. ANSWER: The system call the program was executing has been interrupted
  985. to process the signal, and then it returned -1 and set errno = EINTR.
  986. The program then was likely to draw bad conclusions from that.
  987.  
  988. Explanation: Your program has signal handlers installed, using
  989. signal() or sigaction(). When the signal occurred, your signal handler
  990. was invoked. In other Unix systems, this usually happens asynchronously
  991. or in a few slow system calls:
  992.  
  993.   When a signal is caught during the execution of system calls such as
  994.   read(2), write(2), open(2) or ioctl(2) on a slow device (such as a
  995.   terminal, but not a file), during a pause(2) system call or a wait(2)
  996.   system call that does not return immediately because a previously
  997.   stopped or zombie process already exists, the signal-catching
  998.   function is executed and the interrupted system call then returns a
  999.   -1 to the calling process with errno set to EINTR.
  1000.  
  1001. Linux (following POSIX) checks for signals and may execute signal
  1002. handlers
  1003. * asynchronously (at a timer tick),
  1004. * on return from *any* system call,
  1005. * during the execution of the following system calls:
  1006.   select(),
  1007.   pause(),
  1008.   connect(), accept(),
  1009.   read() on terminals or sockets or pipes or /proc files,
  1010.   write() on terminals or sockets or pipes or line printer,
  1011.   open() on FIFOs or PTYs or serial lines,
  1012.   ioctl() on terminals,
  1013.   fcntl() with command F_SETLKW,
  1014.   wait4(),
  1015.   syslog(),
  1016.   any TCP or NFS operations.
  1017.   [For other operating systems you may have to include the system calls
  1018.    creat(), close(), getmsg(), putmsg(), msgrcv(), msgsnd(), recv(),
  1019.    send(), wait(), waitpid(), wait3(), tcdrain(), sigpause(), semop()
  1020.    to this list.]
  1021.  
  1022. In the last two cases and assuming the program's signal handler returns,
  1023. the system call returns -1 and sets errno to EINTR.
  1024.  
  1025. If the SA_INTERRUPT flag is not set for the corresponding signal,
  1026. however, in most cases the system call is automatically restarted
  1027. (continued) after execution of the signal handler, and your program
  1028. won't see any EINTR.
  1029.  
  1030. You may ask why this is not the default behavior when the default
  1031. Linux signal () is used to install the signal handler. This is because
  1032. POSIX adopted this. As for which one is better, it is a matter of
  1033. opinion.
  1034.  
  1035. Note that in some versions of BSD Unix the default behavior is to
  1036. restart system calls. To get system calls interrupted you have to use
  1037. the SA_INTERRUPT flag.
  1038.  
  1039. Fix:
  1040. Either add -D__USE_BSD_SIGNAL to your CFLAGS. Or for every signal
  1041. handler that you install with signal(), use sigaction() instead,
  1042. without setting SA_INTERRUPT.
  1043.  
  1044. Note that while this applies to most system calls, you must still check
  1045. for EINTR on read(), write(), ioctl(), select(), pause(), connect().
  1046. You may do it like this:
  1047.  
  1048.          int result;
  1049.          while (len > 0)
  1050.            { result = read(fd,buffer,len);
  1051.              if (result < 0) break;
  1052.              buffer += result; len -= result;
  1053.            }
  1054.    -->
  1055.          int result;
  1056.          while (len > 0)
  1057.            { result = read(fd,buffer,len);
  1058.              if (result < 0) { if (errno != EINTR) break; }
  1059.              else { buffer += result; len -= result; }
  1060.            }
  1061.  
  1062. and
  1063.  
  1064.          int result;
  1065.          result = ioctl(fd,cmd,addr);
  1066.    -->
  1067.          int result;
  1068.          do { result = ioctl(fd,cmd,addr); }
  1069.             while ((result == -1) && (errno == EINTR));
  1070.  
  1071.  
  1072.  
  1073.  
  1074. X.B. OTHERS
  1075. ~~~~~~~~~~~
  1076.  
  1077.    X.25)  I seem to be unable to compile anything with gcc. Why?
  1078.  
  1079. ANSWER: If you have only 2 MB RAM, gcc will die silently without
  1080. compiling anything. You must have at least 4 MB to do compilations
  1081.  
  1082. BTW Since swapping is possible, I have heard that compilation works 
  1083. with only 2Meg and a lot disk traffic :) Isn't it great?
  1084.  
  1085.  
  1086.    X.26)  gcc complains about not finding crt0.o and the system
  1087. include files What am I doing wrong ?
  1088.  
  1089. ANSWER: The include files normal place is in /usr/include. lib*.a and
  1090. *.o should be in /usr/lib or /usr/local/lib
  1091.  
  1092.  
  1093.    X.27)  I tried to port a /new/ version of gnu stuff. But in the
  1094. linking phase, gcc complains about the missing libg.a. 
  1095.  
  1096.  
  1097. ANSWER: Yes this is well known for compiler version earlier than
  1098. 2.2.2, throw away the flag -g that's all, anyway libg.a is /only/ for
  1099. debugging purpose. 
  1100.  
  1101.  
  1102.    X.28)  How to compile programs which may be debugged with gdb?
  1103.  
  1104. ANSWER: There are different ways to handle this problem. If
  1105. you have the gcc2.2.2 or later it's simple, use the -g flag. Otherwise
  1106. there are different possibilities:
  1107. 1) As there is no libg.a, you should throw away the -g flag in link
  1108. phase, this means that the compilation must be done in two steps
  1109. example: instead of "gcc -g monprog.c -o monprog", use the following
  1110. "gcc -g -c monprog.c" and then "gcc -o monprog monprog.o"
  1111. Alas this method is not that good if you are using Makefile.
  1112. 2) The other way is to create an empty libg.a as follows (Peter
  1113. MacDonald trick):
  1114. - create libfake.c containing libgfake() {}
  1115. - compile it with: gcc -c libfake.c
  1116. - create the libg.a with: ar r libg.a libfake.o
  1117. 2bis) The more tricky Humberto method:
  1118. cd /usr/lib
  1119. ranlib libg.a
  1120.  
  1121. then gcc -g monprog.c -o monprog will produce a debuggable monprog
  1122.  
  1123.  
  1124.    X.29)  When compiling some code, cc1 complains about some insn
  1125. code, what's that? 
  1126.  
  1127. ANSWER: An insn is an internal representation that gcc uses when
  1128. compiling. The main part of gcc is to take ordinary c (or c++) code,
  1129. and compile it, while ding optimizations in insn part, which is
  1130. soft/hard independant. Then another part which is hard/Os dependant
  1131. takes the insns and translate it in assembly language. The fix is only
  1132. to turn off the optimization flag (-O). 
  1133.  
  1134.  
  1135.    X.30)  When compiling #$@!, I've got some problems with "SIGBUS"
  1136. signal that doesn't exist. Any clue ?
  1137.  
  1138. ANSWER: (Louis J. LaBash, Jr.) SIGBUS is a common problem, its not
  1139. needed, just comment it all out, something like:
  1140.  
  1141. #ifdef SIGBUS
  1142. .. normal sigbus code ..
  1143. #endif
  1144.  
  1145.    X.31)  How can I write codes suitable for building shared library ?
  1146.  
  1147. ANSWER: (Eric Youngdale, eric@tantalus.nrl.navy.mil, 3/1/93)
  1148.   
  1149. In general there are very few restrictions as long as you are using the
  1150. new tools for building sharable libraries.  Before the DLL libraries were
  1151. available there were all kinds of things you had to watch out for, but
  1152. currently you can more or less build a sharable library out of the box
  1153. without making any source code modifications.  See the README in the
  1154. tools-m-n.tar.z distribution for more information on how to build a
  1155. sharable library.  
  1156.  
  1157.  
  1158.  
  1159. XI. SCSI SPECIAL
  1160. ================
  1161. *** This section is written by Drew Eckhardt, mail him for
  1162. *** information, questions related to this section.
  1163. *** Last update May 1993.
  1164.  
  1165.   XI.01)  What hardware is supported?
  1166.  
  1167. ANSWER: The Adaptec 154x, Adaptec 174x, Future Domain 8xx (TMC 
  1168. 950 based boards?), 16x0,  Seagate ST0x, Ultrastor 14F (Some of the 
  1169. new ALPHA code makes attempts to deal with the 34F) and Western Digital 
  1170. 7000 are supported.  Various Adaptec clones from Bustek and Future Domain 
  1171. are known to work, in both ISA and EISA flavors.
  1172.  
  1173. There is an alpha driver for the Ultrastor 24F -
  1174.  
  1175. tsx-11.mit.edu:/pub/alpha/scsi/u24f-driver.tar.z
  1176.  
  1177. Some of the SCSI drivers will not autodetect your SCSI host if the 
  1178. BIOS is disabled, and there may be IRQ, DRQ, address restrictions 
  1179. compiled into the distribution kernel.
  1180.  
  1181. Virtually all SCSI disks, CD ROMS, and tapes should work.
  1182.  
  1183.   XI.02)  What hardware is not supported?
  1184.  
  1185. ANSWER: The Adaptec 152x, 151x, Always IN-2000, DTC, Mylex, PS/2 SCSI boards, 
  1186. all SCSI ports on sound boards, the trantor parallel->SCSI adapter, Rancho 
  1187. SCSI boards, Grass Roots SCSI boards, Trantor SCSI boards, etc.
  1188.  
  1189. Someone is working on a driver for the IN-2000, if you want to run Linux 
  1190. on one of the other boards, you'll have to get technical
  1191. docs on it, and write a driver yourself or bribe someone to do it.
  1192.  
  1193.   XI.03)  How do I get SCSI information?
  1194.  
  1195. ANSWER: Subscribe to the SCSI channel of the linux-activists mailing list.
  1196. mail linux-activists@joker.cs.hut.fi 
  1197. And put in the header.
  1198.        X-MN-Admin: join SCSI
  1199.  
  1200.   XI.04)  Where is the latest version maintained?
  1201.  
  1202. ANSWER: tsx-11.mit.edu:/pub/linux/ALPHA/scsi
  1203.  
  1204. Please join the SCSI channel of linux-activists@joker.cs.hut.fi before you 
  1205. grab anything.
  1206.  
  1207.   XI.05)  I've found one of the following bugs :
  1208.  
  1209. - I can't swap to a SCSI disk, or mount one as /
  1210.  
  1211. - I get a READ CAPACITY FAILED message on bootup.
  1212.  
  1213. - I have a removeable disk (ie Sysquest) and have problems when I change
  1214.     media.
  1215.  
  1216. - I have a Seagate / Future Domain TMC-88x and the kernel panics with a 
  1217.     kernel paging message.
  1218.  
  1219. - I have an Adaptec 1742 and am experiencing data corruption
  1220.  
  1221. - I have an Insite floptical drive and it won't work.
  1222.  
  1223. - I have a TANDBERG TDC 3600 revision U07, SONYCD-ROM CDU-541 revision
  1224.     4.3d, DENON DRD-25X revision V, or a SEAGATE ST296 revision
  1225.     921 and the system hangs or reports multiple devices.
  1226.  
  1227. - My Adaptec 1542C isn't recognized.
  1228.  
  1229. ANSWER: All of these bugs have been fixed, so UPGRADE.  
  1230.  
  1231.   XI.06)  What do I do if I find a bug that still looks like a 
  1232. bug after I've read the FAQ?
  1233.  
  1234. ANSWER: Your best bet is to send it to the SCSI channel of the mailing list,
  1235. where it will be seen by all of the people who've contributed to the 
  1236. SCSI drivers. 
  1237.  
  1238. In your bug report, please provide as much information as possible
  1239. regarding your hardware configuration, and all of the messages that 
  1240. Linux prints when it boots.  Your chances of getting the bug fixed increase 
  1241. exponentially with the amount of information provided.  
  1242.  
  1243. The bottom line is that if we can't reproduce your bug, and you can't 
  1244. point at us what's broken, it won't get fixed.
  1245.  
  1246.   XI.07)  What SCSI disks are supported? 
  1247.  
  1248. ANSWER: Disks up to two terabytes in size will work, since the sd driver
  1249. switches to 10 byte reads when necessary.
  1250.  
  1251. Flopticals, Bernoulis, Sysquests, and other removeable media devices 
  1252. are supported by the normal SCSI disk driver.  
  1253.  
  1254.   XI.08)  What about CD ROMS?
  1255.  
  1256. ANSWER: CD ROMS are supported. The ISO-9660 file system with Rockridge
  1257. extensions is supported.  You will have to make sure that you have 
  1258. configured the kernel to include the isofs filesystem or otherwise you 
  1259. will not be able to use the cdrom.
  1260.  
  1261.   XI.09)  What about SCSI tapes ? 
  1262.  
  1263. ANSWER: Tapes are supported.  You may wish to obtain the utility program mt,
  1264. which is usually available from tsx-11.mit.edu in pub/linux/ALPHA/scsi.
  1265.  
  1266.   XI.10)  How do I partition the disk?
  1267.  
  1268. ANSWER: Use fdisk, efdisk, pfdisk or the DOS parititioning program of 
  1269. your choice.
  1270.  
  1271.   XI.11)  The linux partitioning programs don't work.
  1272.  
  1273. ANSWER: Some of these default to /dev/hd*, which are disks on 
  1274. WD-1003 compatable controllers (IDE, MFM, RLL, ESDI, etc), rather
  1275. than /dev/sd* (SCSI disks).   Your solutions are to 
  1276.  
  1277. 1.  Call the partitioning program with a device name, ie 
  1278.     pfdisk /dev/sda
  1279.  
  1280. 2.  Make links from /dev/hd* to /dev/sd*.  
  1281.  
  1282.   XI.12)  My partitioning program can't figure out the disk geoemetry
  1283.  
  1284. The problem with partitioning SCSI disks and Linux is that Linux talks
  1285. directly to the SCSI interface.  Each disk is viewed as the SCSI host
  1286. sees it : N blocks, numbered from 0 to N-1, all error free.  There is
  1287. no portable way to get disk geometry.  
  1288.  
  1289. However, DOS doesn't like things like this, it demmands that BIOS
  1290. present it with a normal Cylinder / Head / Sector coordinates.  So,
  1291. BIOS does, and it comes up with some fabrication that fits what DOS
  1292. wants to see.  You don't want to disagree with what BIOS thinks when
  1293. you write the partition table. 
  1294.  
  1295. The newest SCSI code will return the mapped geometry for some host 
  1296. adapter / disk combinations.  Kernel release 0.99 and later should have
  1297. this capability.
  1298.  
  1299. QUESTION :  I can't make a filesystem on /dev/hd*
  1300.  
  1301. ANSWER : /dev/hd* aren't your SCSI disks.  /dev/sd* are. 
  1302. See below for approproate major / minor numbers if they 
  1303. do not exist on your root diskette.
  1304.  
  1305.   XI.13)  What are the major / minor numbers for SCSI drives?
  1306.  
  1307. ANSWER: Because of the large number of devices that can be hung off of 
  1308. a SCSI bus (as many as 56 if you use SCSI fanouts or bridge boards), 
  1309. and the possibility of 16 partitions on a SCSI disk, we'd run out of 
  1310. minor numbers if they were statically allocated - so a dynamic 
  1311. numbering scheme is used.
  1312.  
  1313. Block device major 8 is used for SCSI drives, 11 for CD-ROMs.  
  1314. Character device major 9 is used for SCSI tapes.
  1315.         
  1316. Minors are assigned in increments of 16 to SCSI disks as they are
  1317. found, scaning from host 0, ID 0 to host n, ID 7, excluding the host
  1318. ID.  Most hosts use ID 7 for themselves.
  1319.  
  1320. A minor where minor mod 16 = 0 is the whole drive, where minor mod 16
  1321. is between 1 and 4, that partition, extended partitions dynamically
  1322. assigned from 5 to 15 inclusive.  Note that the gendisk.c module
  1323. prints partition tables on initialization - you should be able to see
  1324. them there.
  1325.  
  1326. Example : I have three SCSI disks, set up as follows 
  1327.         Seagate ST02, ID=0
  1328.         Seagate ST02, ID = 5
  1329.         Adaptec 1542, ID = 0
  1330.  
  1331. The first disk on the seagate at ID 0 will become minors 0-15
  1332. inclusive, the second at ID5 16-31 inclusive, the disk on the
  1333. Adaptec 48-63.
  1334.  
  1335.   XI.14)  My tape drive or other removeable media device isn't recognized
  1336. at boot time.
  1337.  
  1338. ANSWER: Try booting with a tape in the drive.
  1339.  
  1340.   XI.15)  How do I reduce kernel bloat and eliminate the drivers I
  1341. don't want?
  1342.  
  1343. ANSWER: For kernel release 0.99 and later, just go to the to directory
  1344. in the kernel source tree, and type ``make config'', and answer the
  1345. questions.  For older kernel distributions, simply #undef
  1346. CONFIG_DISTRIBUTION in include/linux/config.h, and define the macros
  1347. for the SCSI hosts you want enabled.
  1348.  
  1349.   XI.16)  I get SCSI timeouts.
  1350.  
  1351. ANSWER: Make sure your board has interrupts enabled correctly, and 
  1352. that there are no conflicts with other devices (Sound boards 
  1353. and serial boards sometimes try to use IRQ5).
  1354.  
  1355.   XI.17)  My Seagate / Future Domain TMC-88x board is not detected.
  1356.  
  1357. ANSWER: The Seagate and Future Domain boards have memory mapped 
  1358. registers.  To detect them, Linux scans for a signature in the 
  1359. ROM BIOS (typically, a copyright message) and sets the register
  1360. addresses relative to that.  
  1361.  
  1362. This can fail for two reasons
  1363. 1) If the BIOS is disabled.  
  1364.  
  1365. In this case, you should edit kernel/blk_drv/scsi/Makefile and 
  1366. add -DOVERIDE=x -DCONTROLLER=y where x is the base address of your 
  1367. controller (the factory default setting is 0xc8000) - note that 
  1368. this is *not* the segment (ie, 0xc800), and y is the controller 
  1369. type, either SEAGATE or FD.
  1370.  
  1371. 2) If we don't know about your BIOS yet
  1372.  
  1373.  
  1374. Please use DOS and DEBUG to find us a signature that will detect 
  1375. your board - 
  1376.  
  1377. Ie, if your board lives at 0xc800 do
  1378.  
  1379. debug
  1380. d c800:0
  1381. q
  1382.  
  1383. and send me (drew@cs.colorado.edu) the nearest convienient
  1384. ASCII message, with the length and offset from c800:0 or 
  1385. whereever.
  1386.  
  1387.   XI.18)  The Seagate / Future Domain TMC-88x driver doesn't work.
  1388.  
  1389. ANSWER: There are several possibilities
  1390. 1) Is the board jumpered for IRQ5 ? 
  1391.  
  1392. The factory settings are for MSDOS, and have interrupts disabled.  
  1393.  
  1394. On the Seagate, Interrupts are controlled by the W3 (ST01) or JP3 (ST02) 
  1395. jumper.  Shorting pins F-G selects IRQ5.
  1396.  
  1397. 2) Cached machines will not have problems if the Seagate's address
  1398. space (typically C8000 - CAFFFF) is not marked "non cacheable."
  1399. This applies to the i486 internal cache as well as i386/i486 
  1400. external caches.
  1401.  
  1402. This can be set in the XCMOS of most machines.  If you can't disable
  1403. cache for the Seagate's area (16K in size, starting at the base
  1404. address), then you must disable the cache entirely, otherwise
  1405. it won't work.
  1406.  
  1407. 3) If you've defined -DFAST or -DFAST32 in the kernel, blind transfers 
  1408. will be used.  This works fine with most disks, but some won't respond 
  1409. fast enough, the read/write will timeout and things will get out 
  1410. of sync, resulting in timeouts.  Try recompiling your kernel without 
  1411. -DFAST or -DFAST32.
  1412.  
  1413.   XI.19)  The Adaptec driver doesn't work.
  1414.  
  1415. ANSWER: A common source of difficulty is a conflict between two different
  1416. boards for an IRQ level, a DMA channel, or an I/O address.  Check the
  1417. settings for the boards you have in your system (music boards are
  1418. known to use similar IRQ or I/O addresses as the Adaptec.  In the new
  1419. scsi code the Adaptec can use any of the IRQ levels that it can be
  1420. strapped for, it can use I/O address 0x330 or 0x334, and it can use
  1421. DMA channels 5, 6 or 7.
  1422.  
  1423.   XI.20)  The WD-7000FASST driver doesn't work
  1424.  
  1425. ANSWER: According to Keith Smith, 
  1426.  
  1427. "There are two different versions of the WD7000/FASST2  One uses a
  1428. WD33C93A the other a WD33C93.  Firmware incompatibilities in the board
  1429. bios could cause a problem as the former chip fixes some problems that
  1430. were discovered on the latter.  We're talking BOARD firmware, as well as
  1431. BIOS firmware."
  1432.  
  1433.   XI.21)  My Ultrastor 14F or 34F isn't detected 
  1434.  
  1435. ANSWER: The Ultrastor 14F driver won't probe for an Adapter at address
  1436. 0x310.  Either move it do a different address, or recompile the kernel, 
  1437. adding a rule to kernel/blk_drv/scsi/Makefile
  1438.  
  1439. ultrastor.o: ultrastor.c
  1440.     $(CC) $(CFLAGS) -DOVERIDE_PORT=0x310 -c ultrastor.c
  1441.  
  1442.  
  1443.  
  1444.   XI.22)  When using a Seagate / Future Domain TMC-88x, why does my system 
  1445. hang when syncing to disk?
  1446.  
  1447. ANSWER: The Seagate boards are an incredibly brain dead piece of hardware.
  1448. They can only generate an interrupt when a target raises the SEL signal.
  1449. So, as long as a target is connected, the Seagate driver must spin its 
  1450. wheels waiting for the actual data transfer.  Some devices agravate the 
  1451. situation by connecting for long periods of time while not doing anything.
  1452.  
  1453.   XI.23)  My system is dog slow (ie, 60k/sec)
  1454.  
  1455. ANSWER: SCSI commands have an incredible amount of overhead.  For 
  1456. every command, you need to arbitrate for the bus, select the target,
  1457. establish an I_T_L nexus, and send the command.  Processing of that
  1458. command may take as much as 1ms on older devices.  Add this overhead
  1459. to what you already have coming through the file system, buffer 
  1460. cache, etc, and you have a real problem.
  1461.  
  1462. To work around this, we needed to maximize the amount of data that 
  1463. could be transfered in a single command.  So, we implemented 
  1464. scatter-gather, which allows reads/writes from/to contiguous 
  1465. disk sectors to non-contiguous buffers.  
  1466.  
  1467. This typically gets you a 3-5 fold improvement in performance.
  1468.  
  1469. The current kernel has scatter-gather support for the Adaptec, Western 
  1470. Digital, Ultrastor, Future Domain 16xx, Future Domain 8xx and Seagate 
  1471. boards.
  1472.  
  1473.  
  1474.        ===================8<==========>8================
  1475.  
  1476.  
  1477. -- 
  1478. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1479. #    LaBRI              |                        #
  1480. #  351 cours de la Liberation    |  e-mail:  corsini@geocub.greco-prog.fr   #
  1481. #  33405 Talence Cedex         |  e-mail:  corsini@labri.u-bordeaux.fr    #
  1482. #                   |                        #
  1483. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1484. -- 
  1485.      There will be a sig when our local net is reliable.
  1486.            For now, I would rather stay anonymous.
  1487.  
  1488.